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Ee INTRODUCTIUN 


A. BACKGROUND 

Communications Electronics War (COMEL) was developed as 
a manual war game in 1982 by students at the Joint 
Telecommunications Systems Staff Officers Course (TSSOC) aft 
Keesler Air Force Base, Mississippl. The goals af the game 
were to “integrate selected objectives af TSSOC into a 
single exercise" and to give an understanding of “the 
complexities of jyoint communications systems acquisition and 
planning. “ CRef. 1] 

The basic concept of the game was developed by Mayor 
James L. Parrine and other TSSOC faculty members. Their 
concept called for a game based on the assumption that 
“operational forces are only as effective as the comm 
supporting them.“ CRef. el Their initial concept was 
orimarily concerned with acquisition. Each team was to begin 
the game year with given operational communications and 
electronics systems. They ate also given a “shopping list" 
of more sophisticated systems to upgrade their combat 
capabilities. The teams would have research. acquisition, 
and intelligence decisions to make with limited resources 
and a fime constraing€. Subsequent turns would represent 
budget years. The fime limit for each turn is decided by 


the umpire. After each turn there is a probability of going 





to war so the players have to plan their strategies to 
acquire systems as rapidly as possible without exceeding 
their budgets. Random events would be entered into the 
game by rolling dice and via "Gimme a Break” and “Awshucks" 
cards. The initial concept called for the development of an 
obyective evaluation criteria to determine the game winner 
based on acquisition strategies only. 

The concept was further refined to include a cambat 
phase with faculty members acting as controllers and 
evaluators. The first turn af the combat phase involved 
allocating the fielded equipment ‘(allocation phased toa 
combat units in the field in an attempt to optimiza cambat 
unit equipment with communications connectivity. 
Preliminary design goals were defined and given to their 
students to implement as a mayor project af their course. 

The goal of the thesis Been by Rowe and Allgood was 
to develop an automated computer version of COMEL to 
incorporate most of the features of the manual version = and 
to allow later expansion of the game (Ref 1]. The computer 
version was designed in two portions. Allgood designed the 
control modules and the Acquisition Phase modulesi Rowe 
designed the Operations Phase modules. The two portions 
were then combined to form a single game. Rowe and Allgood 
succeeded in fully automating COMEL with the exception of 
the gameboards that are used in the operations phase of the 


game. 





The computer version is resident in the Wargaming, 
Analysis, and Research Laboratory (WAR Lab} at the Naval 
Pastgraduate School (NPS?) and can be modified for use at the 
TSSOC or at any other computer facility with a compatible 
system. COMEL is written in FORTRAN-77 and is currently 
running on a VAX 11-780 with the VMS operating system. In 
addition to the basic thesis. ene Rowe/Allgood thesis also 


contains a detailed users’ manual and maintenance manual. 


B. THESIS GOAL 

The goal of this thesis was to provides graphics 
enhancements to the operations phase of the Rowe/Allgood 
thesis CRef 13 that would result in a fully automated COMEL 
game that will enable the participants to concentrate their 
efforts on the execution of the wargame. Manipulating game 
Pieces on a2 manual gameboard proved to be a tedious task 
that detracted from the primary purpose of the game and was 
a possible source of errors. 

The graphics displays were achieved through the use of 
the DI~SOO0Q graphics software and the Ramtek 7460 graphics 
display system. The BDI~3000 system allows graphics routines 
to be called from FORTRAN programs, permitting the addition 
of a significant amount of graphics to the Rowe/Allgood 
thesis with minor changes to their program. 

The DI-3000 graphics software system is a device- 


independent computer graphics programming system that was 
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designed by Precision Visuals, Inc., and enhanced by 
Lawrence Livermore Laboratories. Device-independenca 
implies that the graphics output will appear to be similar 
when displayed on different graphics display devices. 

A modified users’ manual and a modified maintenance 
manual have been provided as appendices to this thesis and 
include the changes made to reference 1 as.a result of the 


graphics enhancements. 


C. ORGANIZATION 
The remainder of this thesis is partitioned into the 
following chapters: 
Chapter II — Comel Overview 
A comprehensive review of COMEL is provided in this 
chapter. | The purpose and obyect of COMEL are discussad 
briefly. The acquisition phase and the operations phase area 
condensed and examined to provide some insight into the 
game. 
Chapter III — COMEL Corrections 
Software errors were discovered in the ofiginal 
version of COMEL and corrected. The corrections are 
discussed in this chapter. 
Chapter IV -—- General Approach to Graphics 
This chapter explains the approach taken to apply 
GTaphics routines to COMEL. The DI-3000O graphics system is 


discussed so the methods used to present the graphics are 


dl 





understood better. The basic gameboard and unit displays 
are also explained so the theory behind the methods is 
understood. Finally, the methods that were used fo generate 
the graphics display are explained. 
Chapter V — Conclusions 
The results af the thesis are discussed in this 
chapter. 
Chapter VI -—- Recommendations 
Several other enhancements are discussed in this 
chapter. nS the original graphics design was developed 
other areas were discovered that could be better understood 
using graphics displays. Enhancements for the acquisition 
phase and the allocation phase are discussed aspaiie further 
enhancements for the operations phase. 
Appendix A — COMEL Users’ Manual 
This user’s manual contains an abbreviated version 
af the original one created by Rowe and Allgood and confains 
detailed instructions on the use of the COMEL graphics 
enhancements. 
Appendix B -—- COMEL Maintenance Manual 
This manual is patterned after the Rowe/Allgood 
maintenance manual. It only covers the subroutines that 
were modified or created to allow the graphics game fo be 


run. 


i2 





I. COMEL OVERVIEW 


COMEL is a joint communications~electronics war game 
played by a Red Team, a Green team, and an Umpire. Tt was 
developed primarily to train communications staff officers. 
The first version of the game was completely manual. The 
next version was the computer version that was created Oy 
Rowe and Allgood that still uses a manual gameboard. The 
third version, using graphic enhancements, will eliminate 
the manual gameboard and automate the unit movements. 

The obyect of COMEL is to acquire electronics systems 
that can be allocated to units on the battlefield. The 
units, under the direction of the Joint Task Force 
Headquarters (JTFHQ@) will then maneuver and attempt to take 
certain objectives on the battlefield. The JTFH@G@’s for the 
Red and Green Forces are controlled by the National Command 
Authority (NCA). The NCA for COMEL is the Umpire. 

COMEL simulates the three phases of the system life 
cycle. The planning phase of the cycle 1s done prior to 
beginning the computer version of the game. The second 
phase, acquisition. is simulated in the acquisition phase of 
COMEL. The third phase, usage, is simulated in the 
Operations phase of the game. 

The game is divided into two phases, the acquisition 


phase and the operations phase; both can be played during 
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one session or over more than one session. The umpire can 
save the game at any point for resumption of the game at the 
next session. There are default files in the data base to 
provide both sides with a rudimentary set of electronic 
equipment for use during the acquisition phase. Likewise, 
there are default files that can be used if the umpire and 
players want to go directly to the operations phase of the 
game without pleying the acquisition phase. Players can 
design games with different sets of electronic equipment, 
units, gameboard, and probabilities or use default files 


provided with the game. 


A ACQUISITION PHASE 

The first phase, acquisition, includes all those steps 
necessary to design, test and evaluate, produce: and install 
the planned systems (CRef. ded It permits evaluation of 
different systems for possible acquisition and allocation to 
the combat forces in the field. Each game turn 1s 
considered to be a budget year. 

While in the acquisition phase; the Planning, 
Programming, and Budgeting System (PPBS) cycle is utilized. 
The steps of the PPBS cycle that are used in COMEL are (1) 
deciding which systems to buy, (2) putting systems into 
advanced Research and Development (AR&D) or normal R&D, 
(3) advancing systems into Manufacturing for Deployment 


(M&2D), (4) advancing systems into operations and maintenance 


° 
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(O&M), and (5) scrapping systems when no longer needed. Not 
all equipment needs R&D; some equipment may proceed directly 
to M&D. These phases are explained in more detail in 
Reference l. 


While in the acquisition phase the equipment can also goa 


through three phases. The first phase is the actual 
procurement af the equipment. The second phase is the O2M 
phase where O&8M jcaosts are incurred. The final phase 


involves scrapping the equipment if it proves to be tag 
costly or is no longer needed. 
When the acquisition phase of the game begins, a menu is 
presented that gives several options. 
1. Shopping List 
This option shows a shopping list of equipment = and 
systems available for purchase. If the shopping list option 
is chosen, other options are displayed to provide general 
information, technical information, and/or cost information 
on a specific piece of equipment or system. 
2. Systems Status 
When this option is chosen, a submenu is displayed 
that makes available an updated systems summary, a list of 
systems deployed, systems in R&D, systems that have finished 
R&D and are ready for M&D, systems in M&D, and systems 


available to be bought. 
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S Intelligence Reports 


This option provides intelligence reports on the 
status of the opposing force’s systems status. To get the 
intelligence a request for the intelligence must be sent to 
the umpire. The request costs money. The umpire has the 
option of giving the player no information, a little bit of 
information, or a great deal of information. 

4. Budget Analysis/Request 

The budget analysis/request displays a five-year 
cost proyection and allows the budget request for the next 
year to be submitted. By using this option information can 
be obtained to decide whether to allocate resources to have 
equipment developed in real time or have it placed in 
advanced R&D so it can be available sooner. Requests for a 
budget for the next year are also submitted. The umpire has 
the option of allocating the amount that has been requested 
or allocating more or less than was requested. The program 
is designed so the umpire cannot give the players too large 
or too small a budget. 

2. Procurement 

The final option deals with the procurement of the 
equipment and systems. If this option is selected help can 
be obtained thru a decision analysis aid, systems can be 
bought, systems can be scrapped (if the remaining funds are 
running low), equipment and systems in R&D can be placed iin 


accelerated R&D, the R&D effort can be expanded, O&M can be 
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reduced, intelligence can be purchased from the umpire or 
messages can be sent to the umpire, and systems can Ode 
placed in M&D. 

When both sides have made made all of their decisions or 
run out of money or tun out of time, the turn 15 complete. 
The umpire then makes the next move. 

Another acquisition turn can then be played or war Can 
begin at this point. If the decision 13 to continue the 
acquisition phase, the umpire decides how much money ta 
allocate to the red and green players. At this point the 
umpire can also read messages that were sent by the players 
and review requests for intelligence. 

If the umpire decides to terminate the acquisition phase 
of the game and begin the war, the game enters the 


allocation phase. 


B. THE OPERATIONS PHASE 

The operations phase of the game is played on 8 matrix 
gameboard consisting of sixty-six rows with thirty hexes per 
row (figure 1). 

If only the operations phase of the game is played, the 
Red and Green teams can play the game with default forces, a 
default gamebdoard:, and default equipment. The forces and 
equipment are listed below without any capabilities listed. 
& complete description of the units and equipment can be 


found in Reference li. 
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The Green player has the following units available: 


ytfha 6th tfw 
4th cbg Sist tfw 
37 mech 64th atf 


437 arbg 
194 arbg 


37 abn 
6th mab 


Default equipment available to the Green player consists 


of the following: 


artac 1 (4) 
artac 2 vif 
nNavtac 2 (3) 
aftac 2 (2) 
hftty 1 (12) 
wbhs 2 (6) 

awacs (4) 


sat 3 


abncp 


The Red player has 


available: 


morn q 7th cbhg 
24th tfw 21 atf 
S6th tfuw 8th mab 


The default 


consists of: 


attac 1 Vif 

arttac 2 (4) tritac 
navtac 1 (9) sat 1 

aftac 1 (2) gt-sat 1 (3) 
hftty 2 (le) singars 

whs 1 (6) Singargt (3) 
shf-sat abnep 1 (3) 
shf-gt (2) 


The operations portion of the game is 


mco two distinct 


actual operations or combat phase. 


equipment 


phases, 


shf-gt (6) 
tritaceh 


gt-sat 3 (3) 


2 (2) 


the 
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following 


the allocation 


spysat 1 (2) 
atksat 2 (2) 
atksat l 

ew 2 (5) 

ew 3 

ew 42a 


default units 
297 atrbg Sth abn 
81 arbg 41 mech 
available to the Red player 
awacs~-eh (2) 
awacs 
spysat 2 (2) 
atksat 1 (3) 
ew 1 (3) 
ew ga 
ew Ja 
actually divided 


o9hase and the 
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Figure l. 





1. The Allocation Phase 

During the allocation phase of the game. the red and 
green players allocate equipment and systems to their units. 
The only equipment and systems that are available to be 
allocated are those that completed the M&D cycle. Since the 
game turns in the operations phase of the game simulate ona 
day while the game turns in the acquisition phase are a year 
long, the war will be over before equipment and systems iin 
R’%D or M&D can be fielded. 

When allocating equipment, the players must 
understand the capabilities of the equipment. For units to 
be able to communicate with each other and with higher 
authority, their equipment must be compatible. The COMEL 
program checks regularly for connectivity between units 
based on the distance between the units, the type of 
equipment being used, the terrain features, and a random 
factor generated by the computer to simulate changing 
atmospheric effects. When the Joint Task Force Headquarters 
(JTFHQ) issues orders to units: the units must have 
connectivity with JTFHQ to receive the orders. If there is 
no connectivity, the units cannot be ordered to move or 
fight. 

After the allocation phase has been completed, the 


operations phase is started. 
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2, The Operations Phase 


During the operations phase of the game, the 
communications links are affected by range, connectivity, 
terrain, and other factors that simulate environmental 
conditions. A communications link may or may not work. 
Proper allocation of equipment will reduce “communicaticns 
aqutages. " | 

a. Terrain 

Movement, combat, and communications also 
affected by types of terrain encountered. 

(1) Open terrain. Open terrain has no effect on 
the communications system. Moving across open terrain costs 
a unit one movement point per hex. There is no effect on 
combat points. 

(2) Deserts. Desert terrain degrades all forms 
of communications by 20%. Moving across desert terrain 
costs a unit one movement point per hex. During combat 
there 15 a one point advantage for the attacker in terms of 
combat points. 

(3> Mountains. Mountains have the most serious 
effect on communications of all terrain types. They limit 
the tactical communications range to one hex, degrade ground 
wave HF by 40%, sky wave HF by 20% but have no effect on 
satellite communications. If there are two or more hexes 
located less than three hexes from the unit‘’s end of the 


path, no line-of-sight communications are possible. If the 
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mountains are three hexes from the end they will degrade the 
LOS link by 2924. It costs a unit three movement points oper 
re to move through mountains. A defender in the mountains 
receives a two-point advantage in combat. 

(4) Ports and Mines. The city hexes degrade 
tactical communications by 20%, HF groundwave by 40%. HF 
skywave by 20%, LOS by 19%, but have no effect on satellite 
communications. A unit moving through a city hex will lose 
one mobility point per hex. A unit defending from a city 
will have a one point advantage in terms of combat points. 

(3) Woods. Woods degrade tactical 
communications by decreasing the range by one half, degrade 
ground wave HF by 20%, and have no effect on LOS or 
satellite communications. Units moving through the woods 
lose two mobility points per hex. A unit defending in the 
woods has a one point advantage over the attacker. 

(6) Lakes. Lakes degrade tactical 
communications by 19%, degrade all HF communications by 20%, 


degrade LOS communications by 195%, and have no effect on 


satellite communications. Movement across lakes is not 
possible. It would cost a unit 999 mobility points per hex, 
a number that no unit has. Since no unit can be located in 


a lake hex there is no value for combat points. 
(7) Seas. Seas degrade tactical communications 
by 15%, degrade all HF communications by 20%, degrade LOS 


communications by 15%, and have no effect oan satellite 
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Meeninications. The only units that can move on seas are 
ships and marine units embarked on ships. Movement per hex 
costs one mobility point. There is no combat effect in 
combat points. 

(8) Highways. There is no hex type for highways 
but highways do have an effect on mobility. If a unit is 
moving on a highway it only costs the unit a half of a 
movement point per hex. 

b. OQperations Game Play 

This is the portion of the game where units are 
actually maneuvered to try to attain goals and engage in 
combat with opposing units. The rules of engagement (ROE) 
arte established by the NCA and can be changed at the 
beginning of any turn. The ROE can be set so (1)} the NCA 
must approve all attacks, (2) the JTFHG@ can approve attacks, 
or (3) the local commanders can approve attacks. 

There are eight options available that are 
briefly described below that control the actions of the 
units. 

(1) Review Position and Goal Data. The first 
option available to the player is the option to review unit 
positions. If this option is selected, the player is given 
a table that shows that side’s units, the hex coordinates of 
the units, the goals of the units (where the units are 


headed), and the combat points for each of the units. 
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(2) Set / Change Goal for a Unit. The second 


option enables the player to set or change the goal for a 
particular unit. When a new goal is selected for a unit a 
subroutine caiculates the optimum route to the new location 
and displays the information on the screen. 

(3) Change Electronic Equipment Missions. The 
next option available to the player is to change electronic 
equipment missions for systems. 

(4) Assign Recon Missions. The next option 
Bpilows the player to assign reconnaissance missions. The 
player can request photo recon missions for aifcraft or can 
select satellites if satellite systems were available in the 
allocation phase. 

(5) Assign Other Air Missions. The next option 
allows assignment of other air missions. The types of 
missions avallable are interdiction (up to five targets can 


be designated), counter air, and close air support. 


(6) Embark/Disembark Marine Forces. The next 
option allows the marine forces to be embarked = or 
disembarked. To be able to utilize this option, the marine 


force to be embarked must be on a hex adjacent to the 
amphibious task force hex. If the marines are to be 
disembarked, the amphibious task force must be adjacent to a 
land hex. 

(7) Airlift Airborne Forces. The next option 


gives the player the ability to airlift the airborne forces. 
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To do that. the airborne forces must be located at an 
airbase. If they are airlifted, they can move to almost any 
hex on the board in one turn. 

(8) Employ Anti-satellite Weapons. The final 
option for the player is to employ antisatellite weapons if 
available. If the player decides to use antisatellite 
weapons, a request must be made to the NCA. If approved, 
the weapon is employed at the beginning of the next turn. 

When both players are finished with their turn or 
when the time er out for the turn, control passes over to 
the umpire. At this point the umpire reviews the positions 
of the opposing forces, approves or disapproves the use of 
antisatellite weapons, changes the rules of engagement, and 
sets the length of the next game turn. 

The umpire can also stop the game at this time if 
desired even though the results of the game are 
inconclusive. If the umpire decides to continue the game, 
the length of the game turn is entered and the next turn 


begins. 
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Ill. COMEL CORRECTIONS 


Several COMEL software errors were encountered that had 
to be rectified before the graphics portion of the COMEL 
game could be instituted. 

The manual gameboard did not match the default data 
files completely. Two of the most important terrain 
features on the gameboard are the two mountain passes. One 
of the mountain passes was depicted on the gameboard in the 
wrong location, causing ‘the players to position units 
incorrectly and confusing the players on the capabilities of 
their units. The data file was corrected so that it matched 
the manual gameboard. 

Some of the other terrain features were also depicted 
incorrectly. Different types of terrain have different 
affects on the units with regard to their speed and 
communications abilities. The gameboard showed open terrain 
in some areas while the data hase indicated desert terrain. 
In some instances the hexes denoting the sea were improperly 
located, preventing the players from boarding their Marine 
amphibious forces on the shigps. 

The locations of the rivers in the data file were also 
improperly positioned. The locations of the rivers probably 
would not cause any mayor problems with the conduct of the 


game, but for accuracy the data file should reflect the 
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board that the players are using. After noting the 
discrepancies, the data file was altered to match the manual 
gameboard. 

Another software problem was encountered in the COMEL 
command file. One of the options in that file enables the 
umpire to run the game using a tailored map file. When a 
different map file was creatad and the tailoring routine was 
executed, an error message was displayed. The error was 
located and corrected, allowing alternate map files to be 


inserted in the game. 
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IV. GENERAL APPROACH TO GRAPHICS FOR COMEL 


There were several requirements that had to be achieved 
fo canvert the computerized version of COMEL using the 
manual gameboard to the fully automated version using the 
graphics display. | 

The most important capability for the graphics version 
was the ability to read the COMEL data files and properly 
display the information. The graphics enhancement had to be 
flexible enough to be able to read any valid data base that 
a player may design. The gameboard size must be constant, 
but the terrain attributes, the rivers, and the roads can 
all be different depending on the desires of the dasigner. 


The same flexibility had to be made for displaying units 


on the gameboard. The default game only has ten units for 
each team. When the game is played, communications 
equipment can be dispersed. If it 1s. detachments are 
created which must be displayed on the board. The currant 


version af the graphics enhancement will show up to twenty 
different units for each team. allowing the creation af as 
many as ten detachments. It also allows designers to create 


new units in addition to the default game units. 
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A. THE DI-30G00 GRAPHICS PACKAGE 
The graphics enhancement for COMEL could have been 


accomplished without using the DI-S3000 graphics package by 


downloading operations codes directly to the Ramtek 
hardware. The DI-300CG tools were used because they are 
device-independent; i.e., the enhancement wiil require very 


slight modification if a graphics output system other than 
Ramtek is used. Even more, it contains Fortran-callabla, 
high-level routines; i.e., many operations that normally 
require several commands are accomplished with one call fo a 
DI-3000 routine. 

There are two specific drawbacks to using the DI-30c0 
system. One is that when one color is written on top of 
another color, a third color results. This creates 
difficulties when trying to display one color object over 
another. 

Another is that some of the DI-3000 routines that are 
listed in the user’s manual do not execute properly. If a 
call is made to such a command an error message is generated 


when the program is linked to the DI-3000 library. 


B. BASIC GAMEBOARD 

The basic gameboard is created by accessing three 
different data files. They are HEX. DAT, VHEX. DAT, AND 
RHEX. DAT, each of which is a matrix data structure 


consisting of sixty-six rows with thirty characters per row. 
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1. HEX. DAT 
This data file contains the basic terrain attributas 
for the gameboard. There are seven types of hexes used in 
COMEL. 
a. Open Terrain 
The open terrain is depicted in the data file by 
using the letter ‘’‘o’. On the manual gameboard, open terrain 
is shown as yellow. Sree graphics display shows open terrain 
as light green. 
b. Deserts 
The desert terrain is depicted in the data fila 
by ‘d’. The gameboard shows desert terrain as pink. The 
graphics display shows desert terrain as yellow. 
c. Mountains 
Mountains in the data file are represented by 
mi. On the gameboard, mountains are shown as brown hexes. 


The graphics display also shows the mountains as brown 


hexes. 
d. Ports and Mines 
The ports and mines in the data file are shown 
aon c’. On the map they are shown in red. and are red on 
the graphics display. The data file was modified <¢oa 


indicate the locations of the cities, airbases, and forts by 
using ‘c’ for the graphics display. On the gameboard the 


cities, airbases, and forts are shown by outlining the 
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hexes, but on the graphics display they appear better when 
they are shown in red. 
e. Woods 
Woods are shown in the data file by ‘w’. On tha 
map they are shown in green and on the graphics display they 
are shown in dark green. 
f. Lakes 
Lakes are depicted in the data file by ‘1%. On 
the map they are shown in light blue. The graphics display 
also shows them as blue. 
gq. Seas 
Seas are shown in the data file by ‘s%. The map 
shows them as blue, as does the graphics display. 
2. VHEX. DAT 
This data file is used to show the locations of the 
rivers. The file consists of ‘0% ‘1%. and ‘2’ to show 
where the rivers run. Rivers can only run on the boundaries 
between hexes, so the graphics program had to read the data 
file and draw the rivers between the appropriate hexes. 
3. RHEX. DAT | 
This data file is used to show the locations of the 
roads. The file consists of ‘O’ and ‘1%. Roads only run 
from the center of one hex to the center of one of the ae 
adjacent hexes. The graphics program only had to connect 


the centers of the hexes that had ‘i’s in €hem. 
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Cc. UNIT DISPLAYS 

The units are displayed on the basic graphics gameboard. 
They are accessed from within a subroutine that writes unit 
names and locations to the alphanumeric display. Once a 
unit and its location are defined. a subroutine is called 
that associates the unit with an alphabetic character. & 
white solid circle containing the unit’s alphabetical 
character is then placed in the appropriate hex on the 


graphics display. 


D. APPROACH TO GRAPHICS 

Throughout this section, DI-3SOOO subroutine calls are 
used. Rather than explain each one as it called, alli of the 
routines are explained in the maintenance manual (appendix 
2). The general format for a DI-3OCO command is CALL JUXXXXX 
(parameters?) or CALL KXXXXX (parameters). Recall that DI- 
3000 provides a library of fFORTRAN-callable graphics 
subroutines. 

The initial approach used to display the gameboard was 
to draw the hexes required for the gameboard one hex ata 
fime. The center for the initial hex was calculated with 
Tespect to the world coordinate system and subsequent hex 
centers were calculated relative to that center. If virtual 
coordinates were used, the zoom and panning options that 
will be discussed later in the suggested enhancements 


section would not be possible. 
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Once a hex center was located, the coordinates for the 
Six points on the sides were calculated. The next stap was 
to connect the points for the hexes by using JMOVE to move 
to the coordinates of the first point and then call JDRAW to 
connect the first point with the other five points. 

It was noticed that the coordinates of the canters of 
the hexes do not have to be calculated each time the program 
is Tun since they remain constant. To reduce run time the 
centers were precalculated and written to a data file callad 
CENTER. DAT so they could be accessed whenever the plot 
routine was Tun. The calls to JMOVE and JDRAW were replaced 
by using JRPLGN which is used to full the interior af the 
hex with the appropriate color. 

The interior color of each hex is determined by reading 
a data file called HEX. DAT. HEX. DAT specifies the different 
types of terrain used on the gameboard by using a single 
character in a matrix. A routine reads each of the 
characters from HEX. DAT and translates the character value 
into a numerical value that the DI-3000 subroutine JCOLOR 
uses as an index in a color lookup table. The color index 
is then written to a matrix called HEXCOLOR and is used ina 
call to JPIDEX. 

When the interior color of the hex is specified another 
Value is also determined and is written to a seperate matrix 
called BORDER. That value defines the color of the boarder 


to be used when the hex is drawn (edge attribute). When 
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JRPLGN is called it draws the hex using the specified border 
color. The interior style of the hex (color-filled) is 
specified by the JPIDEX subroutine. 

Once the basic gameboard is displayed, the rivers are 
drawn. Drawing the rivers was somewhat more complex becausa 
gach hex has to be examined to determine the locations of 
the rivers with respect to the surrounding six hexes. 
Rivers only run on the common sides between adjacent hexes, 
not through the hexes. 

To draw the rivers a data file is accessed showing the 
Locations of the rivers. If a hex has a value of © assigned 
to it none of the six sides of the hex contains a river. Cf 
a hex has a i or a e@ assigned to it. a river does trun along 
one or more of the sides. If a hex has a value of 1 and any 
of the surrounding hexes also has a value of i. there is no 
river running between them. The same holds true (for 
adjacent hexes with each hex having a value of 2. If 
adjacent hexes have different values (i and 2) a river fruns 
on their common boundary. A data example and its associatad 
output are shown in figure 2. 

The initial approach to drawing the rivers was to 
examine each of the six sides of the hex to determine if 
that hex had a Triver on its boundary, but it was noticed 
that such an approach would cause duplication of effort on 
all interior hexes and some duplication of effort on the 


hexes on the edges of the gameboard. The modified check 
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routine only used three edges of the hex, decreasing thea 
search time by half. After each of the three lower sides af 
a hex is compared to the adjoining hex, a graphics routine 
is called that draws the river on the common boundary if 2 
river exists. 

After the rivers are drawn, the roads are drawn. The 


same general approach is used that was used in drawing the 


rivers. The road data array differs slightly from the river 
data array. If a hex has a value af O there is no road 
running through it. If a hex has a value of 1 it does have 


a road running from its center to the center of an adjacent 
hex. The road can only pass from the center of one hex (fa 
the center of an adjacent hex. The road cannot go from one 
hex fo another one without passing through the center of one 
of the adjacent six hexes (figure 3). The three lower sides 
of each hex were examined to determine if a road went from 
the hex being examined to one of the three adjacent lower 
hexes. If there is a Toad. a subroutine is called that 
draws the road. 

Drawing all of the objects of the basic gameboard using 
the above procedure requires over two minutes. The basic 
gameboard can be saved as pixel data (the Ramtek displays 
1024 x 1280 pixels on its monitor) via section file storage 
and retrieval routines that were created by Lawrence 
Livermore Laboratories. (Ref 2] The section “file" routine 


enables a graphics image in the Ramtek processor to be saved 


35 





RR 


GOOD ROAD 






Figure 2. Tracing Roads Through Hexes. 





Figure 3. Tracing Rivers Through Hexes. 
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nixel by pixel to a file that can be recalled Later by using 
the “retrieve” routine. Since the only graphics output that 
is common to all three displays (red player terminal, green 
player terminal. and umpire terminal) is the display showing 
the basic board, the roads, and the rivers. the section fils 
routine is called after those three elements are drawn and 
the composite image from the Ramtek is written to a map 
file. 

A call to the section retrieval will recall the basic 
map with the roads and rivers on it and display the image on 
the Ramtek display within approximately fifteen seconds. 

The first three graphics outputs (the basic board, the 
rivers, and the roads} were relatively easy to display 
because that information was displayed to each of the 
players’ display terminals (Red, Green and Umpire}. The 
remaining information is displayed to specific terminals and 
not to all three. Some output is displayed only to the ted 
player or to the green player while other information is 
displayed to the red player or to the green player with the 
composite information displayed to the umpire. 

A series of flags was created to select the appropriate 
Ramtek displays depending on the information t0 be 
displayed. By using the flags output could be sent to any 
individual display monitor or to any combination of them. 

When the operations phase of the game is entered: each 


of the players’ units that currently exists is called in 
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turn with its respective location. As the unit‘’s location 
is Tead from a data base and the information is displayed an 
the player’s terminal, a subroutine is called that plots the 
location of the unit on the graphics terminal. 

The simplest way of depicting the units on the screen 
was to use an alphabetic character. It was found that just 
locating a letter on the hex made that letter hard to read, 
even with the line width of the characters set to maximum 
width. One solution to the problem would be to change the 
colors of the letters to provide more contrast to the hexes, 
but this would have meant accessing a data file again and 
would have increased the processing time. The solution used 
was to draw a white circle in the hex first and then draw 
the Letter in the cirele. The circle is small enough so the 
attribute of the hex can be seen but it is large enough g0 
the unit letter can easily be seen (figure 4). 

Another problem that was encountered was deciding how to 
display multiple units in the same hex. When one unit was 
located in a hex with another unit, its unit designator was 
averlayed on the other (see figure 5}. Ta avercome that a 
routine was written that checks the location of each unit ag 
if is accessed from the data file. 

If a unit 1s being located ina hex where there is no 
other unit, if is plotted in that hex. If the unit being 
accessed from the data base is colocated with another unit, 


the new unit is offset one hex. In addition to offsetting 
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the unit. the hex that it 15 plotted in is set to blink fo 
indicate that the unit is not actually located in that hex. 
Even though the unit is shown in a different hex than The 
one it is actually in, the data file is not affected. It is 
possible that a blinking hex could be located adjacent ta 
£ wo non-blinking hexes but the frequency of such an 
occurrence is so remote that no special routine has been sat 
up to clarify where the blinking unit is actually located. 
If an ambiguity did exist it could be solved by viewing the 
unit location meny on the alphanumeric display. 

The Rowe-Allgood COMEL game has routines that will tell 
the player when a unit is in possible contact with enemy 
forces but does not tell the player in which hex the enemy 
unit is located. The graphics enhancement will highlight 
the enemy hex by making it flash But will not display the 
type of eheny unit that is actually there. 

The same is true for surveillance reports. Previously 
the report from aircraft and satellites informed the player 
where an enemy unit was located. The player then was 


required to manually mark the enemy unit’s location on the 


map. With the graphics enhancement. the hex that an enemy 
force is located in will flash. Each time a new hex is 
designated as an enemy hex, that hex will also flash. By 


observing which hexes are flashing and in which order they 


are set to flash a player can track an enemy unit. 
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The enhancements implemented above allow play of COMEL 
without the manual gameboard. All facets of COMEL game play 
are now accomplished through keyboard, alphanumeric and 


graphics interaction with the computer. 
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V. RECOMMENDATIONS 


This thesis dealt only with the graphics enhancement of 
the operations phase of COMEL and did not add any graphics 
capabilities to the other two phases (acquisition and 
allocation>. Possible future enhancements for COMEL are 


discussed in this section. 


& ENHANCEMENTS FOR THE ACQUISITION PHASE 

The acquisition phase of the game uses several bar 
charts to display information but several menus must be 
accessed to review the charts. One graphics enhancement 
that would reduce look-up time would be to display all of 
the charts on the Ramtek. With the high resolution af the 
display each chart could be displayed simultaneously. The 
effects of decisions could be displayed immediately. 
Analyzing the effects of such decisions 15 possible now but 
the process is slow and tedious. The graphics presented 


currently are very crude. 


B. ENHANCEMENTS FOR THE ALLOCATION PHASE 


During the allocation phase of the game communications 


equipment is allocated to units for use during the 
operations phase of the game. Different systems must be 
compatible for each to be effective. A table af 


communications equipment shows which systems are compatible 
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with other systems. Reading this table is tedious. Tha 
tables may be misread and systems may be misallocatad. 
During the conduct of the game there would be no way of 
knowing that the lack of communications was due oO 
misreading the allocation chart. 

Graphics enhancement could help by displaying network 
lines showing the effectiveness of a particular link. A 
piece of equipment could be allocated to one unit and 
another plece of equipment to a second unit. The 
compatibility of that link could be checked by using the 
graphics capability. The capability to allow changing the 
allocation of equipment during this phase would allow 


investigation of alternate allocation schemes. 


C. FURTHER ENHANCEMENTS FOR THE OPERATIONS PHASE 

The graphics enhancement of the operations phase at this 
time shows the location of the units for the red and green 
forces and highlights the hexes where conflicts occur. 
There are other enhancements that can be made for the 
operations phase of the game. 

1. Symbols 

One of the additional enhancements that can be made 

to the operations phase of the game is to use iconic 
representations to represent the units instead of the 


alphabetic characters currently being used. Such an 
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ec eaiont would entail creating and saving the icons in a 
file and recalling them when appropriate. 

There are several methods that could be used ¢a 
depict the units. One would be to create standard military 
map symbols fo display a particular unit. However, the 
small hex size might not allow adequate display of the 
symbols. 

Another method is to let an iconic symbol represent 
the unit. An airplane could represent the different 
tactical fighter wings and small tanks could represent the 
armor units. However, a method of distingushing between 
Like units would have to be established. To display a 
graphic symbol and an identifier in the same smali hex might 
make it difficult to read. 

2. Zoom and Pan 

A graphics enhancement that could resolve the above 
display problems would be the capability to zoom in on a 
particular window of the map. amplifying the size of the 
hexes by as much as eight times. The zoom subroutine is an 
option available on the DI~3000 graphic package. The zoom 
subroutine effectively either changes the JWINDO parameters 
so the real world coordinate limits on the display sereen 
are changed or it replicates pixels. The zoom function does 
not affect the data or the section files. 

In conyunction with the zoom capability is the 


ability to pan around the display area. The panning ability 
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is made Pamela by the use of pick inputs in the form of a 
graphics tablet and a cross~hair cursor device. The upper 
left corner of the tablet represents the upper left corner 
of the virtual coordinate display area. The other threa 
corners of the graphics tablet represent the other three 
corners of the virtual coordinate map. 

By using the zoom and pan options concurrently the 
player can expand the map display and the units on if so 
that symbols on the display can easily be read. 

3. Highlightability 

A further enhancement for the operations phase of 
the game would be to highlight satellite tracks so the 
player knows exactly what portion of the map the 
surveillance satellite 1s covering. The coverage could be 
shown by using flashing hexes or by changing the color of 
the hexes. 

One way to show the coverage would be to open a 
retained segment for the satellite track. A retained 
segment is given a segment number when it is drawn. It can 
be overlayed over a retained segment with a lower segment 
number. Such a segment could be displayed each time the map 
board was displayed. If the satellite track is changed that 
particular retained segment could be deleted and recreated 
using the new coverage track. 

A different way to display the track would be to use 


a timer that would allow the display to be visible for a 
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certain eine period and then delete the segment. A mayor 
advantage of deleting the segment would be to keep tha 
screen from getting cluttered up with information that is 
not required constantly. The option could be added so the 
olayer could have the satellite tracks displayed at any 
time. 
4. Graphics fablet 

Utilization of the graphics tablet and the cursor 
input devices to move the unit would speed up game play. 
The way the game is currently played the player must 
manually enter at the keyboard the destination hex 
coordinates of each unit to be moved. There is ae check 
routine in the game that prevents the player from using the 
wrang hex coordinate pairs (the coordinates must both be odd 
or even) but that does not prevent the player from 
accidently placing units on top of a mountain or in the 
middle of a forest. Using the input devices to select the 
destination of units to be moved will reduce error and =5be 
more user friendly. It will also speed up the play of the 
game. 

2. Lines of Bearing 

When EW units are operating in the ESM made, lines 

of bearing to enemy units within range of the EW units are 


displayed on the alphanumeric terminal. It would be more 
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Mireticial ta be able to see the lines of bearing displayed 
on the graphic display monitor. 

é. Communications Connectivity 

Communications graphics enhancement would be the 

capability to display the communications connectivity for 
each unlt. Such a display could show the probability of 
communications for each of the communications madels for 
each unit displayed as a bar chart so the relative 
capabilities for each unit could be assessed. If one unit 
had a high capability in one area and another unit was low 
in the same area, some equipment from the one unit could 
possibly be reallocated to the other. 

7. Optimum tracks Graphically Displayed 

The current version of COMEL displays the optimum 

track on the aiphanumeric display screen, giving the hex 
coordinates. the player must manually plot the hex 
locations to see the track. A graphic display of the track 
would enable the player to see the proposed track and 
quickly comprehend the unit movement. 

As more experience is gained by playing COMEL more input 


can be generated for possible further enhancements. 
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APPENDIX A -— SECOND EDITION OF THE USER‘S MANUAL 


The purpose of this manual is to supplement the users 
manual that was written for Communications Electronics War 
(COMEL> (CRef. Lj oe documentation of the graphics 
Mee ncenent described in the thesis. The original users 
manual provides an introduction to the game, communications 
and electronics effects, umpire game play, and the players 
game. It provides very detailed instructions in each 
section s0 the red and green players and umpire can 
thoroughly understand the game. 

This supplemental manual will obriefly describe the 
topics that were covered in the original manual and will 
discuss in detail the changes that were made as a result of 


the graphics enhancements described in the thesis. 


A. MAJOR DIFFERENCES 
This section will discuss the differences that the 
players will encounter when playing COMEL with the graphics 
enhancement. 
1. The Gameboard 
The original manual COMEL gameboard is a board 


showing a hexagonal matrix of sixty-six rows and thirty 
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columns. The hex colors indicate the hex attributes. Thera 
are six colors on the manual gameboard. 

The graphics gameboard is very similar to the manual 
gameboard in that it is also a hexagonal matrix of sixty-six 
rows and thirty columns. The graphics gameboard:, however, 
has a seventh color (a second blue) to differentiate between 
the lakes and the sea. Additionally, the cities, forts, and 
airbases are shown in red to make them easier fo see. 

2. The Game Pieces 

The manual gameboard uses small cubes of wood to 
represent the units. Each cube has a small magnet glued to 
fhe bottom to keep the piece in place when the game is being 
played. The pieces being used to designate units have small 
flags with numbers on them to designate different units. 
There are also pieces for the opposing forces without flags 
to use when a hostile unit is detected. If more than one 
unit is located in a hex the player must decide how to 
depict that on the board. 

The graphics version of the game uses letters of the 
alphabet to designate units on the grahics display screen. 
The letters are written in a white circle to make them 
@asier to see against the hexes. If more than one unit is 
located in a hex the first unit is shown in that hex. The 
other units are shown in adysacent hexes with the white 
circles flashing to indicate that the units are not actually 


located in those hexes. 
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3. Unit Movement 

Unit movements for both versions of the game begin 
the same way. When a turn begins the location of each unit 
is displayed on the terminal. The board must then be 
surveyed to determine exactly where each game piece is 
located. If a unit has moved, the new hex location must be 
located and the game piece must be moved to that location. 
In the manual game this is a time-consuming, arror-prone 
operation. 

Using COMEL graphics enhancement the units are shown 
on the graphics display using the information that is still 
displayed on the - terminal. That means as soon as the 
information is displayed on the terminal it is also shown on 
the graphics display. The board no longer needs to be 
surveyed to determine which pieces must be moved. The 
movement is done automatically so there is ~n7no chance for 
errors. 

4. Enemy Locations 

When a sutveillance satellite or reconnaissance 
aircraft locates an enemy unit or when friendly and enemy 
units move into adsyacent hexes, the hex that the enemy is 
located in 1s highlighted by a flashing hex. The 
identification of that unit is not displayed. The flashing 
hex will not be deleted even if a new one is identified, so 


it will be possible to track the movament of an enemy unit. 


o1 


B. RED AND GREEN PLAYERS 


The following sections provide a summary One the 
procedures and directions to play COMEL. See Reference i 
for a more detailed discussion. When ready to run COMEL, 


find a terminal that is connected to the VAX/VMS system in 
the WAR Lab. 
When successfully Logged in to COMEL and the “$" prompt 


appears, type ‘@PLAYER’. The following display will appear: 


ccccc 
ccccc O000 
cc 000000 M M 
cc 00 00 MM MM EEEEEEE 
CC 00 OO MMM MMM PE PEERE es 
Ccccc 00 OO MM M MM SE Et 
ccccc O00000 MM MM EPECEEE Et 
0000 MM MM Et Lod 
M M PEEEEE ee 
EEEEREE fe es ee 
BEECELE 


YOU CAN ENTER THE CARRIAGE RETURN AT ANY TIME. 
UMPTRE PERMISSION [S NOT REQUIRED. 
(C/R) 
When the return key is pressed, a@ menu of options will 


be displayed. 


ve 


# COMEL PLAYER OPTIONS +* 
* CHOOSE: ## + 


OPERATIONS PHASE ONLY 


1 
2 
3 
4 ACQUISITION PHASE ONLY 
2 
6& BOTH PHASES 

E 


EXIT GAME 
a4 
ie Game Information 
The first option will present game information. The 


prompt will ask for a number between O and 24, a number 
which will give a certain page of information. If a QO ig 
entered, a prompt to press the return will appear and the 
program will return to the menu. 
2. Red Player 
The red au selects this option. If both players 
select this option the game will not run properly. 
3. Green Player 
The green player selects this option. As with the 
red option. both players cannot select the green option. 
4. Acguisition Phase Only 
This option would be selected if the acquisition 
phase only is being run; and after selecting either the red 
or green player. Coordination must be made with the other 


player and with the umpire to make sure all game players are 
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using the same option. When this option 15 selected the 


following banner will be displayed: 


He Sh SE SESE SE Se TE TE EE SE SE EEE EE EE EE EEE TE EEE EE EE EEE HEH HHH HHH HAHA 


SoooS FIitt a GGGG EEEEE 
S T AA G = 

SSS T AAAAA G GGG EEEE 
SSSss T a A GGGG EEEEE 
AHH Hee Te ESE SE HE Hh I ESE eb EE SE ESE ESE EE He HE ESE HE ESE SE EE Hh Se ESE Ee ee eh at he ee 
DO NOT ENTER THE CARRIAGE RETURN UNTIL 

INSTRUCTED TO DO SO BY THE UMPIRE 

(C/R} 


# cccc OOO M MeEEEEE  L + 
#% C 0 oO MM TM E L 
%# C 0 GO Met Me EEEE L i 
x ¢cccc OOO M Preeeee ELLLL + 
+ + 
# 4 cccc §@QQ (CU Yeuesssoo 2 rt?! i GGG N Ni 
+ AA C Q QU Uni Ss I 7 ie O NN N # 
% AAAAA C Q QU U I sss MI i: iO ONNWN # 
* A A Ccccc ae UUU I SsSssSS I T I O00 N N # 
+ = 
+ + 
+ + 
+ + 
+ +t 


Once the acquisition stage is actually entered, the 


following menu will appear: 


COMEL ACQUISITION STAGE 
(YEAR 1 : BUDGET $ 500. OM) 
( OBLIGATED $ 0. OM) 


#DECISION TIME: 27 MIN+ 


° SS Se See ee) ee co ce ee) ee eee eae ee = 


° a Se SE ce) ee) ee Se ee ee ce ee a ee ee id 


i SHOPPING LIST 

es SYSTEMS STATUS 

3 INTELLIGENCE 

+ BUDGET ANALYSIS/REG 
2 PROCUREMENT 

S EXIT ACQUISITION 
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a. Shopping List 
This option shows a shopping list of equipment 
and systems available for purchase. If the shopping list 
option is chosen, other options are displayed to get general 
information, technical information. and/or cost information 
on a specific piece of equipment or system. 
b. Systems Status 
When this option is chosen. a menu is displayed 
that makes available an updated systems summary, a list of 
systems deployed, systems in R&D, systems that have finished 
R&%D and are ready for “M2D, systems in M&D, and systems 
available to be bought. 
Ci Intelligence Reports 
This aption provides intelligence reports on the 
status of the epoesing force’s systems status. To get the 
intelligence a request for the intelligence must be sent to 
the umpire. The request costs money. The umpire has the 
option of giving the player no information, a little bit of 
information, or a great deal of information. 
d. Budget Analysis/Request 
The budget analysis/request displays a five year 
cost proyection and allows the budget request for the next 
year to be submitted. By using this oe information can 
be obtained to allocate resources to have equipmant 
developed normally or have it placed in advanced R&D so it 


can be available sooner. Requests for a budget for the next 
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year are also submitted. The umpire has the option of 
allocating the amount that has been requested or allocating 
more or less than was requested. The program is designed so 


the umpire cannot give the players too large or too small a 


budget. 
e. Procurement 
This option deals with the procurement of the 
equipment and systems. When selected help can be obtained 


thru a decision analysis aid, systems can be bought, systems 
can be scrapped (if the remaining funds are running low), 
equipment and systems in R&D can be placed in accelarated 
R&D, the R&D effort can be expanded, O2M can be reduced, 
intelligence can be purchased from the umpire or messages 
can be sent to the umpire, and systems can be placed in M&D. 
t Exit Acquisition 
When selected, the main game menu will return. 


2. Operations Phase Only 


t 


This main menu option is selected to run the 
operations phase only. Again, coordination with the other 
player and the umpire must be made so all game players 
select the same game phase. 

When this option is selected, the following banner 


will appear: 
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Be 3h Sh SE Sb Ht SE SE ESE TE SE SE EEE SE EE ESE EE EE EEE EE EEE HHH HHA HHH HHH 


+ tt 36-4¢ HHH Ht 2 3% SH 4b 36 HE Ht + ~ 
+ + * a + 4t + * + + 
+ + + + + + + + E4t 3 Ht 3 + +t 
+ a + + + + + + + + + 
+ 436-3 3 SEH + +t 3 E3t 3 He $$ 3 3b 36 3 # 
+ + 
+ Ht Ht SH HH ttt + 
% + + % + + +t 
+ ey % 3 3¢-4t tt 3 Ht 3 36 + 
+ + + + + + + 
+ 3 tt + St Ht 3 = 
+ ° + 


Me He HE EEE EE HE ESE EE HE EE HEHEHE HEHEHE AHAHRHEA HEHEHE 
Do not proceed past this point until told to do so by the 
Umpire. When the Umpire tells you to go on, enter (C/R) 

When the operations phase is entered for the first 
time (not for a game that 1s being resumed}. the equipment 
that was developed in the acquisition phase or the equipmant 
that is provided from the default files must be allocated to 
units. When a unit name is specified, lower case letters 
only are used for the name; e.g.,. 35th abn. 

Some large equipment will be assigned a fixed- 
station role and will be located in a particular hex. 

If the equipment is mobile it can be attached to a 
combat unit ead moved with it or it can be detached and set 
up as a seperate communications relay or EW unit. 

Airborne command posts fly on a rotating schedule. 
If one was acquired, it will be available about 45% of the 
time. Two ABNCP‘s will be available about 75% of the time, 


and three or more will be available about 100% of the time. 


AWACS are scheduled in a like manner. 
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Communications satellites have either one area beam 
or several spot beams. The centers of the beams are 
directed at a particular hex with an effectiveness radius 
given. 

Intelligence satellites can survey a number of 
adyacent columns. If any enemy units are located within 
those columns, a message will be oprinted out on the CRT 
giving the hex location but not the identification of the 
unit. 

Anti-satellite weapons can be used against sither 
communications or intelligence satellites. They are usad 
once and only with the approval of the NCA (Umpire>. 

Once the equipment has been allocated, the following 


menu is displayed: 


Action Menu 


Review Position and Goal Data 
Set/Change Goal for a Unit 

Change Electronic Equipment Missions 
Assign Recon Missions 

Assign Other Air Missions 
Embark/Disembark Marine Forces 
Airlift Airborne Forces 

Employ Anti-~satellite Weapons 
Finished Turn 


oS ee a 


Enter the number of your chosen action. 
These options can be used more than once per game 
turn except for option 9 (finished turn) or until the time 
for the turn runs out. The options are briefly described 


below. 
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a. Review Position and Goal Bata 
Shows the current location, destination, and 
combat points for each unit. 
b. Set/Change Goal for a Unit 
Permits movement of combat units. When the goal 
for a unit is 0 be changed, the new coordinatas are 
entered. Depending on the range: terrain, communications 
gear, and other factors connectivity to a unit will not be 
made and the requested order cannot be accepted. An example 
of a successful goal change is: 


Which unit goal do you want to set or change’ 


Enter the unit’s name - up to & spaces. 234 mech 

The goal for the 234 mech is now O O. Is this ok as is? 
yoorn 

n 


What is the desired goal? 

Use O QO to stop the unit in. its present position. 
23 37 

The goal of the unit has been changed to 23 37. 
There will be a short delay while the route is 
being planned. 


The projected path is: 

19 29 i8 30 7 31 16 32 Lo Sa io oS 18 34 
by 3D 21 35 22 36 23 37 

this path will take about 10 movement points. If you 
want to take a different route, resubmit a closer, 
interim goal for this unit. 


c. Change Electronic Equipment Missions 


This option presents the following menu: 


COMM MENU 
Assign ABNCP and AWACS orbits 
Detach equipment for use as a relay or EW unit 
Change comm satellite orbit 
Change EW system mission 
Return to main meny 
Input number of desired action. 


a 
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The first option returns the availability of tha 
ABNCP and AWACS. If one 15 available the center of tha 
orbit is entered. 

The second option detaches equipment and sets it 
up as a seperate detachment. The name for the detachment is 
then entered. 

The third option returns the center focus for 
each communications satellite. The beam Location can then 
be changed or left in its current location. — 

The fourth option designates the mission of the 
EW equipment to be either ECM or ESM. 

The final option returns to the main menu. 

d. Assign Recon Missions 
This option permits satellite surveys or air 


reconnaissance missions to be assigned. 


e. Request Other Air Missions 
When this option 15 selected, several air 
missions can be assigned. The choice of air missions are 
interdiction, close-air-support, counter air, and no new 
missions. Each choice will give some information about the 
option. 
t Embark/Disembark Marine Forces 


To be able to embark a marine brigade onto an 
amphibious task force, the marines must be in a hex adyacent 


4 sea hex and the amphibious task force must be in that sea 
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hex. To disembark the marine brigade, the amphibious task 
force must be in a sea hex adyacent to a shore hex. 

g. Airlift Airborne Forces 

For an airborne force to be airlifted it must 

already be located at an airfield. Once the unit is loaded 
and dropped it must return to an airfield before it can be 
opined again. 

h. Finished Turn 

When selected, the control module is notified 
and returns a message stating that the next turn will begin 
in about ten minutes. The umpire specifies the length of 
the turn but if both teams get finished before the time 
Limit is up, the game can continue immediately. 
6. Both Phases 

If both phases of the game are to be played, select: 

option # 6. 
7. Exit Game 

If this option is selected, the game will be 
terminated. The terminal will return to the system level 
and the “$“ prompt will be displayed. If COMEL is to bea 


played again ‘@PLAYER’ must be retyped. 


C. UMPIRE 
The umpire uses the same procedure as the players to log 
in. Once successfully logged in the system prompt “S" will 


appear. 
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1. Main Menu 
Once the prompt appears type “@COMEL". The 


following menu will appear: 


COMEL WAR GAME OPTIONS 


NEW GAME : DEFAULT DATA/EQUIPMENT FILE EMPTY 
NEW GAME : DEFAULT DATA/OPERATIONS START 
NEW GAME : DEFAULT DATA/ACQUISITION START 
OLD GAME : CONTINUE DATA/DESIGNATED SAVE AREA 
MOD GAME : TAILOR DATA FILES 

SAVE GAME 

DELETE GAME 

DELETE FILE 

REVIEW MAP FILE 

START GAME 

EXIT COMEL 


MUoonourr QD VUe 


All of the options listed are explained in detail in 
the original edition of the users’ manual except for option 
S. The original options will be summarized and option &F 
will be explained in detail. 

a. New Game : Default Data/Equipment File Empty 

This option starts in the acquisition phase with 
no equipment ready for allocation. All equipment to be 
allocated to units when the operations phase begins must be 
acquired during the acquisition phase. 

b. New Game : Default Data/Operations 

This option provides a default set of equipment 
to be allocated to combat units when the operations phase 


begins. it provides typical command and control 
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capabilities to the players. The aperations phase begins 
with this option. 
Cc: New Game : Default Data/Acquisition Start 
This option begins the acquisition phase with a 
rudimentary, default set of equipment already available to 
the units. During the acquisition phase more equipment can 
be acquired. 
d. Old Game : Continue Data/Designated Save Area 
Selecting this option will result in the 


following menu being displayed: 


OLD GAME SELECTION : 
CHOOSE: ## 


EXIT SAVED GAMES 
COMEL WAR GAME 
COMEL WAR GAME 
COMEL WAR GAME 
COMEL WAR GAME 
COMEL WAR GAME 
COMEL WAR GAME 
COMEL WAR GAME 
COMEL WAR GAME 
COMEL WAR GAME 


OQGOnNOMAWAMe ODO 
OMnNO OM ADMe 


This option assumes that a game is being 
resumed. When any number between 1 and 9 is selected the 
game files are loaded with the information from that 
respective game file. When the information has been 
retrieved and the game files have been updated, the main 


menu reappears. 
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5 Mod Game: Tailor Data Files 
When this option is selected, the game can be 
tailored in many ways. Data files from different games can 
be retrieved or the map may be changed. The ariginal thesis 
and the maintenance manual should be read before attempting 
to tailor data files. 
f. Save Game 
When this option is selected, the following menu 


will appear: 


SAVE GAME TO FILE : 
CHOOSE: ## 


## ENTER GAME AREA FOR SAVE 
EXIT GAME SAVE ROUTINE 
COMEL WAR GAME 
COMEL WAR GAME 
COMEL WAR GAME 
COMEL WAR GAME 

WAR GAME 

COMEL WAR GAME 

COMEL WAR GAME 

COMEL WAR GAME 

COMEL WAR GAME 


Von oah Wh © 
-Q 
oO 
=< 
T) 
r 
MQoOoncocuthupne 


When options Ii thru 9 are selected the game 
information is from all files is saved into a master file. 
If a game was previously saved with the same number and a 
new game is saved with the same number, both games can still 
be retrieved. When the game files have been saved, the game 


returns to the main menu. 
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gq. Delete Game 
This option displays a listing of game filas 
that have been stored. Any of the game files can be 
deleted. 
h. Delete File 
If this option is selected, the same opfions 
that appeared under Delete Game wiil be shown, but another 
option will appear that will allow a specific file from a 
version of a game to be deleted. 
1. Review Map File 
This is a new option that is used only with thea 
graphics enhanced version of COMEL. When this option is 
selected, a listing of all of the map files will be 
displayed. These are the map files that can be entered 
later when the request to enter a map file is displayed. 
After the umpire assigns graphics display units to the 
players, the request will appear as follows: 
What monitor is Red using? 
at monitor is Green using? 
vat monitor is the Umpire using? 
3 


Do you want to retrieve a previously saved map file? 


3 
Do you want to specify a map name? 


If not. the default COMEL map will be used. 
n 
The above answers to the prompts would result in 


the default COMEL game map being drawn on all initialized 


monitors. 
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If a new hex map 1s going to be created, rust 
creating the data file is not sufficient. The map must be 
drawn on the Ramtek before it can be saved as a map file. 4 
new map is created by making a copy of HEX. DAT and changing 
the hex attributes. If new rivers and roads are alsa 


desired VHEX. DAT and RHEX. DAT must also be copied and 


modified. As soon as the map has been drawn on the Ramtek, 
a prompt will ask for the map file name. When the map has 
been written to the map file, 1t willl be available “for 


retrieval. 
J. Start Game 

This option will start the game. If the game 15 
terminated by entering Control Y or Control C, control of 
the game will pass back to the game menu. The intormation 
in the current turn is lost but any previous information is 
still in data files and can be saved by using the Save 
option. 

When this option is selected, the following meny 


will appear: 


Hom a = - # 
+ COMEL WAR GAME OPTIONS + 
+ CHOOSE: ## + 
tm + 


GAME INFORMATION 

RUN ACQUISITION ONLY 

RUN OPERATIONS PHASE ONLY 
RUN COMPLETE GAME 

EXIT COMEL 


oP WM 


HE 
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The first option will provide game information. 
The next three options will begin the phase or ohasas 
selected. The last option will return control of the game 
to the main menu. 
The umpire is an active participant in all phases of 
COMEL. 
2. Acquisition Phase 
When the acquisition phase is started, the following 


banner is displayed: 


Be SESE TE SE EEE SE SESE SE SE SE SE SESE SE SESE SESE SESE TE SESE SE TE SESE SESE TEESE TE SESE SESE ETE EE EE EE HE EEE HE 


zeeecccC OOO M Mm eeeee +e 
% C 0 O MM MM E Es + 
*# C 0 Geet? Meek Ee + 
feecccC OOO M i SeEme. Pee LL + 
+t +t 
+ 4 cccCc @G@Q UV U I SSSSS I TTTTT § OOO N No ot 
+ AA C @ QU Ui Ss I T ir oO O NN WN # 
# AAAAA C Q QU Ute oscse,) | T i OQ ON NN # 
+ A A CCCC QQ UUU I Sssss I t I 900 N N # 
+ *% 
meesoooso Til ity a GGGG EEEEE es 
+ S T AA G E cS 
=) OSS T AAAAA G GGG EEEE # 
* SSSSS il; ~ A GGGG EEEEE + 


SE 6SE SESE EE FE SE SE EE SE EE SE TEE SE ESE ESE SE HEE SE HEE EEE Ht EE EE EE EE EH SE EE EE EE eet 
PLEASE ENTER A 4-7 DIGIT ODD NUMBER TO BE USED AS A SEED 
FOR THE RANDOM NUMBER GENERATOR USED TO DETERMINE 

THE START OF THE WAR: 

The odd number is used to generate a random number 
to determine if the war has begun. War can occur at any 
time beginning in year two on. 

The next request is for the length of the turn in 


minutes. The program will not accept a game turn of less 
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than ten minutes. 


back to the menu. The first 


(suggested time is YO minutes) so 


familiar with the different options. 


be shorter (recommended 60 


should be even 


players finish their turns before the time has expired, 


If 0 is entered the game control will 


go 
game turn should be fairly long 


the players can become 


The second turn should 


minutes} and subsequent turns 
shorter (recommended 3O minutes). lf both 
the 


game will go on to the next turn. 


There are several decisions that must now be made. 


a. Budget 
An annual budget 


prior to each year of the 


umpire decide how much money 


five year budget summary 


item to remember is that the 


team between 10 £and 


requests are not shown in the budget summary 


funds must be allocated. 


20 Megabucks 


15 determined for each team 


acquisition phase. To help the 


to allocate to each team, a 


is displayed upon request. One 
intelligence requests cost each 
Those 


per request. 


§0 additional 


After the Budgets are entered the 


program goes into the synchronization and control phase. 


b. Synchronization and Control 
The synchronization and control of the 
acquisition phase is controlled by the system. Once the 
return key 1S pressed the following message is displayed on 


the umpire’s terminal: 


WAITING FOR GREEN & RED...17: 30:25 
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When the red and green players have been told fo 
enter the acquisition phase of the game the display on the 
umpire’s terminal will display the time remaining in that 
game turn. When the time has expired or when the players 
have finished their turns, the game will continue to the 
intelligence update routine. 

c. Intelligence Update 
As soon as the intelligence update routine is 


entered, the following menu will appear: 


$m— + 
# INTELLIGENCE UPDATE MENU + 
+ CHOOSE ## + 
4———-— = + 


RED GAME SUMMARY 
GREEN GAME SUMMARY 
READ RED MAIL 
READ GREEN MAIL 
INTEL REQUEST 
GREEN INTEL REQUEST 
UPDATE RED INTEL 
UPDATE GREEN INTEL 
EXIT INTEL 


MOnNOoUAWNMeE 
A 
m 
oO 


" 

The first and second options will produce a menu 
that allows the status of the red and green players 
respectively to be reviewed. 

The third and fourth choices will produce any 
mail from the red or green players. 

The fifth and sixth options will display any 
intelligence request from the red and green players. If 


there is a request that means that the team that made the 
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request spent money from its budget. If the umpire decides 
not to provide any intelligence, the money was spent far 
nothing. A request can be made for specific or general 
intelligence with the level of intelligence returned being 
an umpire decision. 

The next two options provide the capability fa 
respond to the players’ intelligence request. The response 
to the players is a free format narrative. 

When the final option is selected and the return 
is pressed, either the game continues on to the next 
acquisition year or war begins. If a message is displayed 
on the umpire’s terminal stating that war has begun, the 
umpire can override the beginning of the war. Ir war 15 
allowed to begin, the operations phase begins. 

3. Operations Phase Control 

During the operations phase of the game the umpire 
controls the length of the game turns. For the first turn a 
decision must also be made to either begin a new operations 
phase or to resume a previously saved game. 

If a new operations phase is being entered the 
umpire decides whether to use default equipment files or to 
DUild new equipment files. 

At the beginning of each turn the umpire (NCA) 
decides on what level to set the rules of engagement (ROE). 
Initially, the NCA must approve any attacks. As the game 


progresses the NCA can change the ROE so the JTF commander 
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or the Noa commander can approve attacks. The NCA must 
always be consulted to approve the use of anti-sateallita 
weapons. 

At the end of each tutn the NCA can stop the war. 
If one side controls the mayor and minor objectives that 
Side is a decisive winner and the game ends. I# neither 
side is a decisive winner, the NCA can declare a cease fire, 
save the files, and continue on later or the NCA can declare 
one of the teams a winner based on the current situation. 
Using the Ramtek graphic display the umpire can eee see 
the disposition of the units for both teams. making it easy 


to follow the progress of the teams. 


BD. SUMMARY 

This manual is only a summary of the original COMEL 
user’s manual and does not go into great detail on some of 
the options available to the red and green players and the 
umpire. This manual is being merged with the original 
user’s manual which is available in the COMEL game file an 


the computer system Located in the WAR Lab. 


Zi 





APPENDIX B — SECOND EDITION OF THE MAINTENANCE MANUAL 





The purpose of this manual 15 to supplement tha 
maintenance manual . that was written for Communicatians 
Electronics War (COMEL) CRef 1] with documentation of the 
graphics enhancement described in the thesis. The original 
maintenance manual documented the software used in COMEL 30 
that it could be modified easily. The program was written 
using modular design, frequent comments, and structured 
FORTRAN in an attempt to write code that could be read, 
understood, and modified by novice programmers. Further 
information can be found in the COMEL User’s Manual CRef i] 
and in the COMEL Thesis CRef 1]. 

This supplemental manual will list each module that was 
modified to support the graphics enhancement package. 
Duplicate information not required to support the graphics 
has been omitted. 

This manual follows the same structure as the original 
manual s0 a2 person familiar with the original manual can 


understand the supplement without learning a new format. 


A. HARDWARE/SOFTWARE DEPENDENCY 
This section describes the characteristics of the 


program that make COMEL and the graphics enhancement 
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dependent on the specific computer and operating system for 
which it was designed. 

COMEL was developed on a Digital Equipment Corporation 
VAX 11-780. The operating system used is VMS. The graphics 
portion of COMEL was written using Precision Visual’s bBi- 
3000 graphics software, FORTRAN-77, and the RAMTEK 7446 
graphics system. The DI-3000 graphics system was designed 
to be hardware independent so i1t can be used with other 
types of graphics display systems. 

FORTRAN-77 programming constraints such as the IF-THEN- 
ELSE-IF., are used extensively, as is variable type character 
which allows alphabetic responses to questions with direct 
Bor checking. Such FORTRAN constructs permit easy 
structuring of the program and enhances 1%5s maintainability 
and readability. To modify the game program to compile with 
other dialects of FORTRAN that do not support these features 
would require a line-by-line review of the code to locate 
and modify these structures. 

Nearly all of the graphics routines rely on the DI-30Oco 
FORTRAN-callable routines. The BDI-S3O0CO package provides an 
extensive Library of graphic subroutines that are easy fo 
use. If COMEL is trun on a system that does not have a DI- 
3000 library. the program would have to be examined = Iline- 
by-line to determine where the DI-3000 calls are located and 
to determine what routines would have to be written to 


accomplish the same results. 
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B. GRAPHICS ENHANCEMENTS 
Lt. COMMON VARIABLES (GRAPHICS ENHANCEMENT 3 
The graphics anhancement uses eight COMMON 
stataments in addition to the ones usad in tha original 
version of COMEL. Tha common statements and their 
respective variables are identifiad below. 
COMMON /CONFLICT/ conunt 
conunt - integer: a variable that is used ta 
incremant the saaneee for segment numbers when accessing a 
routine that highlights haxes that have possible conflict 
Situations. [It indicates a CONflict UNIT. 
COMMON /COPY/ mapnamea 
mapname - character; identifies tha map being usad 
for tha display. When the display 15 arasad mapname allows 
fhe map to ba radrawn without the umpire reentaring thea 
nama. | 
COMMON /COPY1/ copyflag 
copyflag - loagicali signifies that SUBROUT INE 
RETRIEVE is being accessed from SUBROUTINE DELETE and not 
from SUBROUTINE HEXxX. Copyflag passes tha control of thea 
program over tha questians found in thea first part of 
SUBROUTINE RETRIEVE. 
COMMON /DELETE/ maxx,maxy 
maxx ~- integeri a counter that keaps track of the 
number of red units that have been displayed. If tha number 


of red units is not accurately tallied, tha call to JPURGE 
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will 
units being left on the screen if the count 


maxy —- integer; 


number of green units that 


number of green units is not accurately tallied, 


JPURGE will result in an error message if 


high or units being left on the screen if the count 


low. 


a counter that keeps 


have been displayed. 


result in an error message 1% the count 15 too Algh or 


1s too low. 


track of the 
If the 
the call to 
the count is too 


1s too 


COMMON /GRAPHICS/ ratio. iriver, iroad, xi, yl 


Tatio —- real; 


to set the display window size (JWINDO?. 


a variable that is used by the BI-3000 


The value of ratio 


is determined by using a routine called JASPEK. 


iriver (66,30) - integer; an array 


which hexes have Trivers on their boundaries. 


iroad (466,30} - integer: an array 


which hexes have roads Tfrunning through them. 


x1 (66,30) - reali the x-coordinate 
of the hex 

yl (66,30) — reali the y-coordinate 
of the hex 


COMMON /MONITOR/ rmon, gmon, umon 


rmon - integeri a variable that 


Ramtek monitor the red player’s output will 
Variable that 


gmon - integer: a 


Ramtek monitor 


on 
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that designates 


that designates 


for the center 


for the center 


specifies which 
be displayed on 


specifies which 


the green player’s output will be displayed 





umon —- integer; a variable that specifies which 
Ramtek monitor the umpire’s output will be displayed on. 
COMMON /REPOS/ ad 
ad - integer: a variable that is used as a sudscript 
when repositioning units 
COMMON /USERS/ reflg.grnflg 
redflg - logical: a flag used when the red player 
reviews his unit positions. If the flag were not used, 
SUBROUTINE RPOSIT would call SUBROUTINE UNTPLT and try to 
redraw the units in their current positions. That would 
create an error condition. 
gtmnflg - logical: a flag used when the green player 
reviews his unit positions. [If the flag were not usad, 
SUBROUTINE GPOSIT would call SUBROUTINE UNTPLT and try to 
redraw the units in their current positions. That would 


create an error condition. 


C. THE GRAPHICS MODULES 

Several subroutines were developed to perform certain 
functions. These in turn call various DI-3000 routines for 
generating the actual graphical obyects for the bameboard. 
These routines are examined in this section. 

Parameters are variables passed between routines in the 
call statement. 

1. SUBROUTINE CHKI 


File: HEX2. FOR 
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Purpose and Method: 

This subroutine is used to compare the adisacant 
upper right hex to a given hex fo sea if a river flows 
between the twa. If a river does flow between the two a 
graphics routine is executed that draws the river. 

Parameters: 
on - integers: coordinate oair for a twa- 
dimensional matrix 
Common Variables Referenced but Not Changed: 
Xl, Yi, iriver 
Entries: 
SUBROUTINE HEXX 
2. SUBROUTINE CHK2 
File: HEX2. FOR 
Purpose and Method: 

This subroutine 1s used to compare the adjacent 
lower right hex to a given hex to see if a river flows 
between the two. If a river does flow bhetween the two a 
graphics routine is executed that draws the river. 

Parameters: 
l,j - integersi coordinate pair for a two- 
dimensional matrix 
Common Variables Referenced but Naot Changed: 
Xi, Yi. iriver 
Entries: 


SUBROUTINE HEXX 
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ate SUBROUTINE CHKS 
File: HEX2. FOR 
Purpose and Method: 


This subroutine 15 used to compare the 


adjacent 


bottom hex to a given hex to see if a river flows between 


the two. If a river does flow between the fwo a 
routine is executed that draws the river. 
Parameters: 
lr; j - integers: coordinate pair “for 


dimensional matrix 


Common Variables Referenced but Not Changed: 


Xl, Yi, iriver 
Entries: 
SUBROUTINE HEXX 
4. SUBROUTINE RCHK1 
File: HEX2. FOR 
Purpose and Methad: 


This subroutine is used to compare the 


graphics 


2 two- 


adjacent 


top right hex to a given hex to see if a road runs between 


the two. If a road does run between the two a 
Toutine 1s executed that draws the road. 
Parameters: 
l,j ~ aintegersi coordinate pair “(for 


dimensional matrix 


Common Variables Referenced but Not Changed: 


Xi, Yi. iroad 


78 


graphics 


a two- 





Ehituues - 
SUBROUTINE HEXX 
9. SUBROUTINE RCHK2 
File: HEX2. FOR 
Purpose and Method: 

This subroutine is used to compare the adjacent 
lower right hex to a given hex to see if a road runs between 
fhe two. If a road does run between the two a graphics 
routine is executed that draws the road. 

Parameters: 
l,j - integersi coordinate pair for a ‘fwo- 
dimensional matrix 

Common Variables Referenced but Not Changed: 
Xi, Yi, iroad 

Entries: 
SUBROUTINE HEXX 

6. SUBROUTINE RCHKS3 

File: HEX2. FOR 

Purpose and Method: 

This subroutine is used to compare the adyacent 
bottom hex to a given hex es see if a road runs between the 
two. If a road does run between the two a graphics routine 
is executed that draws the road. 

Parameters: 
l,j - integersi coordinate pair for a two- 


dimensional matrix 


a 





and 


display new maps. 


iG lah ae? eC 


Common Variables Referenced but Not Changed: 


Xl. Yl. iroad 
Entries: 

SUBROUTINE HEXX 
SUBROUTINE HEXX 
File: HEX1.FOR 


Purpose and Method: 


This subroutine is used by the umpire to 


Ramte k 


monitors, 


COMEL uses this subroutine to 


retrieve 


assign 
map files: and 


read map 


data files and to draw new mapboards with roads and rivers. 


copyflag 


Common Variables Reference but Not Changed: 


ratio 


Common Variables Changed: 


iriver, iroad, 


Subprograms Called: 


SUBROUTINE SETUP 


x1, yl, 


SUBROUTINE RETRIEVE 


SUBROUTINE CHK1 


SUBROUTINE CHK2 


SUBROUTINE CHKS 


SUBROUTINE RCHK1 
SUBROUTINE RCHK2 
SUBROUTINE RCHKS 


SUBROUTINE FILE 


Data Files Accessed 


11 hex center 
11 - game board 
12 river data 


TMoOnNn, 


gmon, umMmon, 


and File Specificatioan: 


coordinates 


attributes 
file 


13 - road data file 
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CENTER. DAT 
HEX. DAT 
VHEX. BAT 
RHEX. DAT 





Entries: UMPIRE. FOR 
8. SUBROUTINE RETRIEVE 

File: RETFILE. FOR 

Purpose and Method: 

This subroutine is used to retrieve a previously 
saved map file and display 1 on the Ramtek display devices 
that have been initialized. 

Common Variables Referenced but Not Changed: 
umon, ratio, copyflag 

Common Variables Changed: 
mapname 

Entries: 
SUBROUTINE HEXX 

9. SUBROUTINE FILE 

File: RETFILE. FOR 

Purpose and Method: 

This subroutine is used to store a map file that 
has been drawn on the Ramtek display. The umpire assigns a 
name to the map file. 

Common Variables Referenced but Not Changed: 

Tatio, -umon 

Entries: 
SUBROUTINE HEXX 
10. SUBROUTINE REPOS 


File: REPO. FOR 
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Purpose and Method: 
This subroutine is used fo reposition units that 
are collocated with other units. 
Parameters: 
indx — integeri used as a counter for a do loop. 
It is used to count the number of times different units are 
encountered in the subroutine. 
row —- integer; passes the row value for the unit 
being checked 
col —- integer: passes the column value for the 
unit being checked 
xine - integeri x-increment for the x-coordinate 
of the unit being checked 
yince —- integer: yr-increment for the y-coordinate 
of the unit being checked 
Common Variables Changed: 
ad 
Entries: 
GEN6. FOR 
11. SUBROUTINE SETUP 


File: HEX1.FOR 
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Purpose and Method: 

This subroutine is called to initialize the 
Ramtek display devices that the umpire has designated for 
use. It also defines the display area and defines some 
colors that are not default colors. 

Parameters: 
li - integer; used to indicate which Ramtek 
monitor is being initialized 
Common Variables Changed: 
ratio 
Entries: 
SUBROUTINE HEXX 
i2. SUBROUTINE RTURN/GTURN 
File: REDi. FOR/GREENI. FOR 
Purpose and Method: 

This subroutine offers a menu of possible 
actions, inputs the player’s choice, calls the appropriate 
subroutine, and then loops back for another choice. 

Initialize temporary values for equipment. 
Present player action menu. 

Parameters: 
stopat - reali scheduled time for end of turn 
Common Variables Changed: 
redflg 
13. SUBROUTINE REDGOAL /GREENGOAL 


File: RED1. FOR/GREENI/FOR 
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Purpose and Method: 

This routine allows the player to change tha 
movement goal of a combat unit. displays a projected path, 
and allows the player to input an interim point to taka 
another path. 

Input unit name and check identity of the unit. 
Check communications link to see if change of orders can be 
sent to the unit. Display present goal of unit and ask 
player if he wants to change it. Ask for new goal, ‘O Q% to 
be input to stop a unit in its present position. Dutput new 
goal and proposed path. If the unit is a sealifted Marine 
force, the goal remains that of the Amphibious Task Force 
carrying the Marines. 

Major Variables: 

unitna —- character#8; name of unit input by 
player 

effcS - reali effectiveness of communications 
Link to JTFHQ 

Tng - integer; distance to hq 

Tn - reali random number 

Common Variables Changed: 
Tgoal/ggoal 
Common Variables Referenced but not Changed: 
rmon/gmon/umon, redunt/grnunt, rrow/grouw, 
reol/gcol, rforce/gtforce, rpeathr/gpathr, rpathc/gpathc, 


rstart/gstart, rend/gend. rlenth/glenth, rseal/gseal, seed 
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Subprograms Called: 

SUBROUTINE OPTIM 

Real function C3EXT 

Real function NCACON 

System function RAN 

Entries: 
SUBROUTINE RTURN/GTURN 
14. GUBROUTINE UNTPLT 
File: UP. FOR 
Purpose and Method: 

This subroutine assigns an alphabetic character 
to each unit and displays the unit in its appropriate hex. 
It also draws a circle in the hex so the unit letter will de 
more visable on the hex. 

Parameters: 

1i a subscript used to identify units 

hxxi a subscript used to designate the x<x- 
coordinate of a unit 

hxyi a subscript used to designate the y- 
coordinate of a unit 

segpr; a counter used to define a segment 
priority 

segcliri a counter used to designate the color of . 


the unit letter 
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Common Variables Referenced but Not Changed: 

xl, yl 

Entries: 
SUBROUTINE RPOSIT., GPOSIT 
15. SUBROUTINE ENDWAR 
File: UMPFILES8. FOR 
Purpose and Method: 

This subroutine determines whether either sida 
has won the war in a decisive victory. [Tf not, it gives 
status to the Umpire and allows the Umpire to decida whether 
to artificially declare an end to the war with or without a 
marginal victory for one side. 

Determine if either side controls the mayor 
obyectives by checking the last owner of hexes listed in 
KEYA. Determine if either side controls the minor 
obyectives in the same way, using hexes listed in KEYS. Lf 
the same side controls both mayor and minor obyectives 
declare them the decisive victors and end the game. If one 
side controls the major objectives and the other side 
controls no minor objectives, the first side has a marginal 
Victory. Allow the Umpire to decide whether to end the 
game. If one side controls all mayor obyectives but the 
enemy controls any minor objectives, the outcome is 
indecisive. Allow the Umpire to decide whether to end the 
game and whether to declare the first side a winner. Lf 


neither side controls the major objectives, there is no 
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winner. Allow the Umpire the option of ending the game in a 
ceasefire. 
Parameters: 

over - logical; true if controller decides ta 
end game or if one side has achieved a victory 

redflg/grnflg -— logicali true if subroutines 
RPOSIT/GPOSIT are called to prevent the subroutines from 
replotting the locations of the units 


Other Mayor Variables: 


row, col — integers; location of a kay obsective 

mayor —- character * 1; side which controls mayor 
ob yactives 

minor —- character * 1; side which controls minor 
obyectives 

winner —- character #* 353i side which is winning oar 


ahead 
Common Variables Referenced but Not Changed: 
keya: keyb, lasown 
Subprograms Called: 


SUBROUTINE RPOSIT/GPOSIT 
SUBROUTINE RLISTEN/GLISTEN 


Entries: SUBROUTINE OPNCTL 
16. SUBROUTINE OPNCTL 


File: UMPFILE1. FOR 
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Purpose and Method: 

This module provides timing and sequencing for 
the Operations Phase of the game. 

Output Operations game header. Check whether 
starting a new gamei get seed and call input subroutine or 
read blackboards. Display unit positions to set up map. 
Loop through turns. Input turn length and rules of 
engagement. If it is not the first turn, cutput 
intelligence. Output blackboards. Wait for the players to 
finish turns, checking periodically for messages or and ~of 
time limit. When time is up or both players ara finished, 
continue with movement, combat, and end of war decision. 


Mayor Variables: 


hhmmss ~- character#8; time 
first - integar;: rules af engagement 
ictl,igrn, ired,it,ishr,ismn ~- integers; action 


completion flags 


durmin - real; length of turn in minutes 
dummy, s,stemp - reali dummy variables 
stopat ~ reali scheduled end of turn 
over ~ logical; true if game is to end 


Common Variables Changed: 

conunt, redflg, grnflg, copyflag 
Subprograms Called: 

SUBROUTINE PAGE 


SUBROUTINE DELAY 
SUBROUTINE TIME 
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SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUT INE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 


Entries: 


WRITIT 

READIT 
RMSG/GMSG 
SYSOUT 

SYSBRD 

REDOUT /GRNOUT 
RULES 

OP INTEL 

INPUT 
RPOSIT/GPOSIT 
RMOVE /GMOVE 
DICTION 
COMBAT 

ENDWAR 
REDBRD/GRNBRD 
DELETE 


main program UMPFILEL. FOR 


17. SUBROUTINE DELETE 


File: GEN6. FOR 


Purpose and Method: 


This subroutine is used to delete the uwnit 
displays so the new positions can be plotted. 
A call is made to JPURGE “which deletes the 


entire display. COPYFLAG is used to recall the basic map 


and SUBROUTINE RPOSIT and SUBROUTINE GPOSIT 


are called toa 


display the new unit locations. 
Common Variables Referenced but Not Changed: 


rmon, gmon, umon, copyflag, mapname, maxx, maxy 


Subprograms Called: 
SUBROUTINE RETRIEVE 
Entries: 


Main program GENS. FOR 
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18. SUBROUTINE RPOSIT/GPOSIT 
File: GEN6. FOR 
Purpose and Method: 

This routine displays the unit name, location, 
goal, and combat points for each unit. It also passes the 
unit location and name to UP.FOR to plot the locations of 
fhe units on the graphics terminals. For @ach unit, write 
Values presently in the common variables. 

Parameters: 

redflg/grnflg —- logical; if true, subroutine 

untplt is not called 
Major Variables: 
maxx/maxy —- integers: indicate the maximum 
number of red and green units 
Common Variables Referenced but Not Changed: 
rmon, gmon. umon 
Common Variables Changed: 
ad 
Subprograms Called: 

SUBROUTINE REPOS 

SUBROUTINE BLINK 

SUBROUTINE UNTPLT 


Entries: 


SUBROUTINE RTURN/GTURN 
SUBROUTINE ENDWAR 


19. SUBROUTINE HILITE 


File: GEN2. FOR 
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Purpose and Method: 
This subroutine is used ¢0 highlight hexes 
containing enemy units. 
A DBI-3SOOCG routine is called that makes a 
specified color blink. 
Parameters: 
row/col - integers; subscripts that specify and 
x and y coordinate pair for a hex 
Common Variables Referenced but Not Changed: 
rmon, gmon, umon, xi. yl 
Common Variables Changed: 
conunt 
Entries: SUBROUTINE ENEMY 
20. SUBROUTINE ENEMY 
File: GEN2. FOR 
Purpose and Method: 
This subroutine surveys HEX (row, col } and 
adyacent hexes for enemy units. 


Identify adjacent hexes and initialize logical 


to false. Survey hexes;: if owner is other side or both, set 
logical. 
Parameters: 
Tow,col —- integersi center hex 
side —- character * 1i side doing check 
cnflect - logicali true if other side is presenf 


91 


: | 





Other Mayor Variables: 
iu,id,ius., ids, jl. yr ~ integers: row or column of 
adjacent hexes 
Common Variables Referenced but Not Changed: 
owner 
Subprograms Called: 
SUBROUTINE HILITE 
Entries: 

SUBROUTINE FIGHT 

SUBROUTINE MVMENT 

SUBROUTINE RMOVE/GMOVE 

21. SUBROUTINE RTURN/GTURN 
File: RED1. FOR/GREEN1. FOR 
Purpose and Method: 

This subroutine offers a menu of possible 
actions, inputs the player’s choice, calls the appropriate 
subroutine, and then loops back for another choice. 

initialize temporary values for equipment. 
Present player action menu. 

Parameters: 
stopat - reali scheduled time for end of furn 
Major Variables: 

choice - character#i:i menu selection 

airlft - logicali true if an airdrop has already 
been requested for this turn 

Common Variables Referenced but Not Changed: 


redtilg/grnflg 
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Common Variables Changed: 
rrecce/grecce 
Subprograms Called: 

SUBROUTINE REDGOAL/GRNGOAL 

SUBROUTINE RCOMM/GCOMM 

SUBROUTINE RRECON/GRECON 

SUBROUTINE RCACAS/GCACAS 

SUBROUTINE RPOSIT/GPOSIT 

SUBROUTINE RSEALTIFT/GSEALIFT 

SUBROUTINE RAIRLIFT/GAIRLIFT 

SUBROUTINE RATKSAT/GATKSAT 

SUBROUTINE RTERAIN/GTERAIN 

Entries: 

SUBROUTINE REDOPS/GRNOPS 

e2. SUBROUTINE REDCOAL/GRNGOAL 
File: REDi. FOR/GREENI. FOR 
Purpose and Method: 

This routine allows the player to change the 
mavement goal of a combat unit, displays a proyected path on 
the Ramtek display and on the terminal, and allows the 
player to input an intermediate point to take another path. 

Input unit name and check identity of the unit. 
Check communications link to see if change of orders can be 
sent to the unit. Display present goal of unit and ask 
player if he wants to change it. As for naw goal, ‘OQ Q’% toa 
be input to stop a unit in its present position. Output new 
goal and propased path. If the unit is a sealifted Marine 


force, the goal remains that of the Amphibious Task Force 


carrying the Marines. 
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Major Variables: 


unitna —- characters; mame of unit imput by 
player 
effc3 - reali effectiveness of comm Link ¢a 
JTFHG 
rng - integer; distance to hq 
Tn - treali random number 
Common Variables Changed: 
Tgoal/goal 
Common Variables Referenced but Not Changed- 
redunt/grnunt, prathr/gpathr, rpathc/gpathc, 
Trow/grow, rcol/qcol, rforce/gforce, rstart/gstart, 
rend/gend, rlenth/glenth, rseal/gseal, seed, rmon, gmon, 
umon 


Subprograms Called: 
SUBROUTINE OPTIM 
Real Function CS3EXT 
Real Function NCACON 
System Function RAN 


Entries: 


SUBROUTINE RTURN/GTURN 


D. DI-3000 CALLS 

The DI-3000 routines that are used throughout COMEL are 
explained to provide the user with a general understanding 
of what each command accomplishes. For a more detailed 
explanation of these variables the user should consult the 


DI-300G User’s Guide. CRef. 2] 
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1. JASPEK (DSPDEV, RATIO} 
This routine returns the display surface aspect 
ratio of a specific graphics display device. The aspect 


ratio defines the shape of the visible region of a display 


device. 
DSPDEV defines an initialized graphics display 
device. 
RATIO is the aspect ratio (height/width) of 
DSPDEV. 
2. BEGIN () 


YEND 

JBEGIN initializes BI-3000 and guarantees that DI- 
3SCOO is in the system initialization state with all default 
parameters, attribute, and mode settings established. 

YVEND terminates DI-30C00QQ and insures that ali 
graphics output is complete to all selected display devices. 
Any initialized and selected display devices are deselected 
and terminated. 

3. JBGBAT (LEVEL) 

This routine is used to begin a batch of updates 
that enables the DI-300C0 to process a large number of 
picture changes without displaying each picture change. The 
composite picture is the only one displayed so the amount of 
time utilized in calls to the display device is reduced. 


LEVEL sets the level of the update. 
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4. JCIRCL (xO, YO, ZO, RADIUS, NSEG?} 

JCIRCL is used to output a circle on a projection 
plane parallel to the rxy-plane of the world coordinate 
system (monitor surface). 

XO, YO, and ZO designate the center of the circle 
in world coordinates. 

RADIUS specifies the radius of the circle in 
world coordinates. 

NSEG specifies the number of line segments to ba 
used to draw the circle. If NSEG is less than three, JCIRCL 
will choose a number of segments relative to the length of 
the radius to make the circle as smooth as possible. 

5S. VJCOLOR (CVALUE > 

JCOLOR specifies the current color to be used when 
displaying obyects on the display device. 

CVALUE specifies one of the colors available for 
the display. Colors O thru 8 are preset and colors 9 thru 
32,767 are defined by the user. 

6 JCOTBL (DSPDEV, COUNT, INDEXS, HUES, SATS, LIGHTS} 

This feature allows the user to download portions of 
the color table on a specified display device. 

DSPDEV specifies a particular display device. 

COUNT sets the number of elements of the device 


level color table that are to be defined. 
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INDEXS lists the array of color table indixes ¢o 
be defined. Since colors O thru 8 are reserved (sae 
JCOLOR}, the user can specify color numbers ? fhru Sa, 767. 

HUES is an array of values that make it possible 


to classify color as red, green, blue or intermediates of 


the three primary colors. Hue is defined as an angie iin 
degrees. A value of O indicates pure blue, 120 indicates 
pure red, and 240 indicates pure green. Intermediates ares 


specified by indicating a value between the primariesi e.g., 
yellow would be 180 (between red and green). SATS is an 
array that determines the degree to which a color differs 
from a gray of the same lightness. & value of CO indicates 
pure gray and a value of Ge, 767 indicates a pure color with 
no gray. 

LIGHTS determines the amount of lightness 
assigned to each color. A value of O indicates that the 
color is black (no light) through various grays to 32,767 or 
white (maximum Light). 

7. WJDINIT (DEVICE?) 

JDEVON (DEVICE> 

JDEVOF (CDEVICE} 

JDEND (DEVICE} 

These four commands are used together. DEVICE 
specifies which display device is to be addressed. JDINIT 
initializes the display device and must be called before any 
output can be sent to that device. JDEVON turns the device 


on, JDEVOF turns the display device off, and JDEND deselects 


the device and terminates if. 
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8. JDRAW (X,Y? 

This routine is used to draw a line from the current 
position to the specified world coordinate position. Thea 
new position is determined from the arguments associated 
with JDRAW. 

X specifies the x~-coordinate of the new 
location. 
Y specifies the y-coordinate of the neu 
location. 
9. JENBAT (> 

JENBAT is used to signify the end of the batch 
picture processing (see JBGBAT>. 

10. JESCAP (CODE, NINTEG, NREAL, ILIST, RLIST? 

There are several escape CODES that can be called in 
the DI-3000 library that provide an access mechanism for a 
device independent DI-3000 application program to utilize 
special hardware capabilities of the selected display 
surfaces. Three calls to JESCAP with different values for 
fhe CODE were made in the graphics routines. The values 
associated with them will be explained after each of tha 
arguments. 

CODE specifies which function code is being 
accessed. 
9408 - indicates that a particular color in the 


color table is to blink. 
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9424 —- used to write a properly formatted 
section file (pixel file) to a Ramtek. 

9425 - used to read a window of pixels from the 
Ramtek and write a properly formatted section fila. The 
section file must have already been created using either 


KSCRET or KSOPEN. 


NINTEG is the number of integer parameters to 


the ascape function. It 15s the dimension of ILIST. 

9408 -— the number of integers used in this call 
1s 2. 

9424 — the number of integers used in this call 


memerther Lor 2. 
9425 -— the number of integers used in this call 


is either 1 or 2. 


NREAL sets the number of virtual coordinate 
parameters passed fo the escape function and 15 the 
dimension of RLIST. 


9408 - the number of reals used in this call 1s 


9424 -— the number of reals used in this call 1s 
either O or @2. 


9425 - the number of reals used in this call 15 


either O or 4. 
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ILIST is the array of integer parameters passed 
to the escape function. 

9408 -—- the first array element specifies the 
color table index. The second array element turns off the 
blink (0) or turns on the blink (13. 

9424 —- the first array element designates the 
first address of the section file as specified by KSOPEN. 
The second element. if used, specifies a bit plane erase 
mask. 

9425 - the first array element 1s the.address of 
the section file as returned by KSOPEN/KSCRET. The second 


@lement, if used, specifies a bit plane read mask. 


RLIST is the array of real parameters passed to 


the escape function. 


9408 - there are no real array elements for this 
Gail. 

9424 - 1f used, the two array elements specify 
fhe x- and y-coordinates of the lower left corner of the 
window into which the pixels are written. If not specified, 


the coordinates that are used are the same ones that are 
used to read the section file. 

9425 - 1f used, the two elements designate the 
x- and y-coordinates of the lower left corner of the window 


into which pixels are written. 
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fi eee  (CEUDE, DSP DEV, EIESFC) 
JFILES overrides the default specifications for thea 
logical unit number of a DI-300C0O internal file. 


CODE indicates the DBI-3OCO internal code to0 £=be 


changed. Four internal files can be changed. They are the 
error file, debug file, graphics output file, and graphics 
input file. 


DSPDEV is an uninitialized display device that 
will Later be initialized. 
FILSPC is the new file specification for tha 
internal file and is usually a FOTRAN logical unit number. 
12. JFONT  (CVALUE) 

JFONT sets the current character font primitive 
attributes. 

CVALUE defines the character font of subsequent 
primitives within a currently open segment. 
i3. JHTEXT (NCHARS, STRING) 

JHTEXT outputs a graphic arts quality test string as 
an output primitive. It is the highest quality text output. 
Lower quality text output is available by calling JITEXT, 
JETEXT, and JSTEXT. 

NCHARS is an integer value that specifies the 
number of characters to be written on the display device. 
STRING is the literal string to be output to the 


display device. 
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14. JINTEN (CVALUE) 

JINTEN sets the current intensity of the orimitiva 
attribute. 

CVALUE defines the level of intensity with 
Values ranging from O thru 32, 767. 

iS. vJLWIDE (CVALUE) 

JLWIDE sets the current line width primitive 
attribute. 

CVALUE specifies the Line width with the range 
going from O to 32. 767. 

16. JMOVE (X,Y) 

JMOVE moves the cursor from its present location toa 
a new location without drawing any lines on the display 
device using absolute world coordinates. 

X defines the x-coordinate of the new position. 

Y defines the y-coordinate of the new position. 

17. JPEDGE (CVALUE) 

JPEDGE defines the current polygon edge style. The 
polygon edge style indicates the method of forming the 
border of a visible polygon. . 

CVALUE specifies the polygon edge style within 
the currently opened segment. It can have values from © 
thru 32, 767. Even values indicate that the edge style is 
solid. Odd values indicate that the edge style is to have 
the same attributes as the interior of the polygon (see 


JPINTR? wifh no seperate border. 
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i8. JPIDEX (CCOLOR, CINTEN) 


JPIDEX sets the current interior color and intensity 


attributes. 
CCOLGR sets the 
polygons 


CCOLOR is O to 32, 767. 


CINTEN sets the intensity 


polygons within the currently opened segment. 


CINTEN is O ta 32, 767. 
19. JPINTR (CVALUE> 
JPINTR sets the current 
attributes which determines the 


interior of a polygon. 


CVALUE specifies which 


interior 


within the currently opened segment. 


color of subsequent 


The range for 


level of subsequent 


The range for 


polygon interior style 


method of filling thea 


style of interior fill is 


to be used. GQ indicates that the polygon is not to be 
filled. 1 indicates that the polygon is to be solid filled 
with the color specified by JPIDEX. Other values (2 thru 
32,757) are device dependent values. 
20. JRPLGN (DX, DY,N) 
JRPLGN outputs a polygon in 2-D relative world 
coordinates. A polygon is created by an invisible move to 


the first point, 
the array, 
back to the first point. 


interior to be filled. 
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line drawings to the subsequent 


This option allows 


points in 


with a final draw from the Nth point in the array 


the polygon’s 





DX specifies the x-coordinate of the canter of 
the polygon. 

DY specifies the y-coordinate of the center of 
the polygon. 

N defines the number of points in the polygon 
array. 

21. JPURGE (NAME) 
JPURGE deletes a retained segment and releases the 
segment storage space allocated to NAME. 

NAME specifies which retained segment is to be 
deleted. If a retained segment NAME does not exist, an 
error message will be printed. 

22. JROPEN (NAME) 
JROPEN opens a retained segment. 

NAME is the name of the retained segment and is 
an integer value. It can have a value from i to S32, 00d. 

23. JSETDB (LEVEL} 
JSETDB sets the DI-300Q0 graphics debugging level. 
By changing the debugging level the verbosity af the 
traceback statements will be changed. 

LEVEL specifies the level of verbosity for 
JSETDB. The levels range from O (no comments) to 7 (full 
DI-3000 traceback). 

24, JSGPRI (NAME, SEGPRI) 
JSGPRI controls the segment priority of a retained 


segment and determines the order (from front to rear) in 
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which the retained segments are displayed on an initialized 
display device. 

NAME is an integer value that specifies whose 
segment priority 1s to be changed. 

SEGPRI specifies the priority of segment NAME. 
A higher value segment will be displayed over a lower value 
segment. A value of O indicates that retained segments havea 
no priority. Values ranging from 1 to 32. 767 specify a 
segment priority. 

25. JVSPAC (CVXMIN, VXMAX, VYMIN, VYMAX). 

JVSPAC redefines the dimensions of the virtual 
coordinate system and the mapping from the virfual 
coordinate system onto the visible region of all selected 
display devices. When JBEGIN is called, the default virtual 
coordinates of the display device are VXMIN = -1.; VXMAX = 
1.0; VYMIN = -1.0; and VYMAX = 1.0. JVSPAC changes the 
boundaries to the values specified. 

VXMIN sets the minimum value for the virtual 
x-coordinate boundary. 

VAXMAX sets the maximum value for the virtual 
x-coordinate boundary. 

VYMIN sets the minimum value for the virtual 
y-coordinate boundary. 

VYMAX sets the maximum value for the virtual 


y-coordinate boundary. 
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26. JWINDO (CUMIN, UMAX, VMIN, VMAX} 


JAWINDO defines the boundaries of a2 window in tha 


real world coordinate system. When JBEGIN is called the 
world coordinate boundary limits are XMIN = -1.0; XMAX = 
1.05 YMIN = -1.0; and YMAX = 1.0. JWINDO lets the user 


define the minimum and maximum values of the display area. 

UMIN is a teal value that specifies the minimum 
value of the horizontal axis. 

UMAX is a teal value that specifies tha maximum 
Value of the horizontal axis. 

VMIN is a teal value that specifies the minimum 
value of the vartical axis. 

VMAX 165 a real value that specifies the maximum 
Value of the vertical axis. 

27. KSBYTE24 (DSPDEV, VXLL, VYLL, VXUR, VYUR) 

ASBYTE24 is used to get the number of bytes of 
pixels used to display an image in a virtual screen window. 
This version of KSBYTE also includes overhead associated 
with calling JESCAP 9424 and JESCAP 9425. 

DSPDEV specifies the device to ba examined. Lf 
is a value that is entered by the user. 

VXLL and VYLL specify the x and y coordinates 
respectively for the lower left corner of the virtual 
coordinates of the display area. They are values that are 


specified by the user. 
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VXUR and VYUR specify the x and y coordinates 
respectively for the upper right corner of the virtual 
coordinates of the display area. They are values that ara 
specified by the user. 

28. KSCRET (FILENAME, ISIZE, LUN, [CHANNEL, TADDR, IERR} 
KSCRET is used to create a section file of a 
specified size and is mapped into the user’s virtual address 
space (user directory). 

FILENAME is the name af the section file to ba 
created. It is a character string that is specified by the 
user. 

ISIZE is the size of the file in bytes. It is a 
Value that is determined by calling ASBYTE or KSBYTES24. The 
created file size is rounded up tao an integral number of 
blocks (Si2 bytes = 1 block}. 

LUN is the logical unit number on which the file 
1s being created (mass storage device such as a disk}. 

ICHANNEL is the channel number that the 
operating system assigns to the mass storage device for data 
transfer. 

IADDR is an array of two elements that specify 
the starting and ending addresses of the section file where 
it now exists in the segment storage area. Both are -1il if 


the mapping failed. 
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TERR is a flag value that is passed if the file 
could not be opened. ASCRET will display an error message 
if IERR returns a value other than O. 

29. KSOPEN (FILENAME, LUN, [CHAN, PADDR, TERR? 

KSOPEN is used to open a section file and map the 
file into the space that has been defined for the display 
device. 

FILENAME is the name of a previously stored 
section file. It is specified by the user. 

LUN is the logical unit number that the 
operating system assigns to the mass storage device for data 
transfer. 

ICHAN 1s the channel number that the operating 
system assigns fa the mass storage device tor data transfer. 

PADDR is a two dimensional array that indicates 
the opening and ending address af the secfion file in the 
segment storage area. Both are -1l if the mapping failed. 

TERR is an error flag that is returned if the 
file could not be oapened. The flag would cause KSOPEN to 
display an error message on the terminal. 

30. KTOHSL (R,.G, B.H,S, LL, NDAC} 

ATOHSL is used to define colors using their fred, 

green, and blue values. The routine returns values for 


hues, saturations, and lights which are passed to JCOTBL. 


108 





R is the brightness of red to be used. O is no 
red and 15 is the maximum amount of red. This value is 
specified by the user. 

Gis the brightness of green to be used. The 
Tange of values is the same as for red. This value is 
specified by the user. 

Bis the Brightness of blue to be used. Thea 
range of values is the same as for red. This value is 
specified by the user. | 

H is the value of the hue (see JCOTBL for a 
definition of hue). It is a value returned by ATOHSL as a 
result of the values entered for R, G and B. That value is 
then passed to JCOTBL. 

S is the value of the saturation lavel (see 
JCOTBL for a definition of saturation). The other 
attributes are similiar to H. 

Lis the value of the light level (see JCOTBL 
foo a definition of tLight?}. The other attributes are 
similar to H. 

NDAC specifies the number of bits for each color 
for the color look-up table. The value can either be 4 or 
8. If the value is 4 the range for R, G and B is from 0 to 
is. If the value is 8 the range for R, G, and B is from O 


to 295. 
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e. COMPLETE MAINTENANCE MANUAL 
This supplementary maintenance manual has been merged 
with the original manual and is in the WAR Lab computer. It 


is accessible from the COMEL directory. 
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